home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / text / misc / htmldoc.lha / readme.txt < prev    next >
Text File  |  2001-07-11  |  3KB  |  110 lines
  1.  
  2. NOTE FOR AMIGA USERS:
  3.  
  4. Please download and install the ixemul environment if you don't have it
  5. on your system. (Available at my web page)
  6. Use a large stack in your shell before running HTMLDOC (I use 1 mb)
  7.  
  8. Email me if you have problems: Fr3dY (fr3dy@retemail.es)
  9.  
  10.  
  11.     **** PLEASE READ THE DOCUMENTATION BEFORE ASKING QUESTIONS. ****
  12.  
  13.     Documentation for HTMLDOC is available in the "doc" subdirectory
  14.  
  15.     HTMLDOC supports most HTML 3.2 and some HTML 4.0 markups as well as
  16.     GIF, JPEG, and PNG images.  Eventually HTMLDOC will be compliant
  17.     with HTML 4.0 and support style sheets.
  18.  
  19.  
  20. INTERNET RESOURCES
  21.  
  22.     For general discussions about HTMLDOC, subscribe to the HTMLDOC
  23.     mailing list by sending a message to "majordomo@easysw.com" with
  24.     the text "subscribe htmldoc".
  25.  
  26.     The HTMLDOC home page is located at:
  27.  
  28.         http://www.easysw.com/htmldoc
  29.  
  30.     The current version of HTMLDOC can be also downloaded from:
  31.  
  32.         http://www.easysw.com/software.html
  33.  
  34.     Commercial support is available from Easy Software Products; send
  35.     requests to "htmldoc-support@easysw.com" (note: support via this
  36.     email address is only provided to customers with a valid support
  37.     contract!)
  38.  
  39.  
  40.  
  41.     HTMLDOC accepts a list of HTML "source" files and will generate
  42.     HTML, PostScript, or PDF output via command-line options.  A
  43.     summary of command-line options can be shown with the "--help"
  44.     option:
  45.  
  46.         htmldoc --help
  47.  
  48.     HTMLDOC normally expects "structured" documents, with chapters,
  49.     etc.  Chapters begin with a <H1> markup and continue to the end of
  50.     the listed HTML files or the next <H1> markup, whichever comes
  51.     first.  To convert unstructured documents such as web pages, use
  52.     the "--webpage" option to HTMLDOC:
  53.  
  54.         htmldoc --webpage ...
  55.  
  56.     To generate a Level 2 PostScript file you might use:
  57.  
  58.         htmldoc -f outfile.ps chapter1.html ... chapterN.html
  59.  
  60.     Similarly you can generate a PDF file of the same source files
  61.     using:
  62.  
  63.         htmldoc -f outfile.pdf chapter1.html ... chapterN.html
  64.  
  65.     Finally, to generate HTML files for viewing (with a linked table-
  66.     of-contents) do the following:
  67.  
  68.         htmldoc -t html -d outdir chapter1.html ... chapterN.html
  69.  
  70.     or:
  71.  
  72.         htmldoc -t html -f outfile.html chapter1.html ... chapterN.html
  73.  
  74.     A complete description of all command-line options and HTML
  75.     guidelines can be found in the software users manual in the "doc"
  76.     directory.
  77.  
  78.  
  79. CURRENT LIMITATIONS
  80.  
  81.     - No support for style sheets.
  82.     - CAPTIONs are always shown at the top of the table.
  83.     - HTML 4.0 table elements and attributes are not supported
  84.       (rules, THEAD, TFOOT, etc.)
  85.  
  86.  
  87. CREDITS
  88.  
  89.     Many thanks to Leonard Rosenthol (leonardr@lazerware.com) for
  90.     providing changes to support a MacOS version of HTMLDOC.
  91.  
  92.     The table VALIGN and "HALF PAGE" code was contributed by
  93.     D. Richard Hipp (drh@acm.org).
  94.  
  95.     The RC4 encryption code is from librc4 1.1 by the folks at
  96.     Carnegie Mellon University.
  97.  
  98.     The MD5 hash code is from L. Peter Deutsch (ghost@aladdin.com)
  99.     at Aladdin Enterprises (creators of Ghostscript).
  100.  
  101.  
  102. ENCRYPTION SUPPORT
  103.  
  104.     HTMLDOC includes code to encrypt PDF document files using the RC4
  105.     algorithm with a 40-bit key. While this software and code may be
  106.     freely used and exported under current US laws, other countries may
  107.     restrict your use and possession of this code and software.
  108.  
  109.  
  110.